home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 401-425 / disk_418 / ljp / ljp.doc < prev    next >
Text File  |  1992-05-06  |  14KB  |  371 lines
  1.                     
  2.                     LaserJet Print  Version 1.01        By: Khalid Aldoseri.
  3.                     ----------------------------
  4.                     
  5.                     
  6.                     
  7. WARNING:
  8. --------
  9.  
  10.     This program can ONLY be used with a Hewlett-Packard LaserJet, LaserJet+
  11. or the LaserJet Series II printer, or an HP LJ compatible printer..
  12.  
  13.  
  14. QUICK DESCRIPTION:
  15. ------------------
  16.  
  17.     The program's main target is to print out TEXT files onto the HP LaserJet
  18. printer.  But that's not all, it can do the following things:
  19.  
  20.  
  21.     -   Print in Landscape or Portrait modes.
  22.     -   Use any built-in font, cartridge fonts, and even soft fonts.
  23.     -   Will automatically download soft fonts into the printer.
  24.     -   EXTREMELY fast printing.  (This is done by totally bypassing the 
  25.         Preferences printer.device).
  26.     -   Can print one or TWO logical pages on a single paper.  (This is the
  27.         same as my LJ2 program.)
  28.     -   Multiple styles of page headers with date/time, file name, and page
  29.         numbers.
  30.     -   Length and Width of page adjustable in inches.
  31.     -   Has preset lengths/widths for paper sizes of A4, Letter, Legal, 
  32.         and Executive.
  33.     -   You can specify the Pitch & Point of a font and it will be selected.
  34.     -   Selection of Bold and Italic fonts, plus limited support for
  35.         proportional fonts. (This will be fixed in a later release.)
  36.     -   Fine control over the Lines Per Inch setting.
  37.     -   You can specify the number of characters per line needed and the
  38.         correct font size will be selected, if such a font exists.
  39.     -   Selectable margins for top, bottom, left and right.
  40.     -   Selectable Tab spacing.
  41.     -   Multiple copies.  (Uses printer's # of pages facility.)
  42.     -   Can print line numbers, either for the whole file or per page.
  43.     -   Completely intuition-ized with file requesters for file selection and
  44.         soft font selection.
  45.     -   You can call up your favourite editor directly from the program with
  46.         the selected file loaded automatically.
  47.     -   Serial or Parallel port can be selected.
  48.     -   The program has SEVEN different sets of settings that can be used
  49.         for different jobs as required.  These can be SAVED and will be
  50.         automatically loaded everytime you run the program.
  51.     -   Shrink window facility to make the program disappear and just leave
  52.         a tiny window that can be selected to have the program come up again.
  53.         (Thanks to UEdit for the idea for this.)  Also a CLI option to have
  54.         the program start up as a tiny window for all you Startup-Sequence
  55.         fans.
  56.  
  57.  
  58. PROGRAM REQUIREMENTS:
  59. ---------------------
  60.         
  61.     OK.  Now to get the program running all you have to do is double-click
  62. its icon from the Workbench, or type 'LJP' from the CLI.  But first you must
  63. do the following things:
  64.  
  65.     -   Tell the program what your favourite editor is.  This is done by
  66.         assigning the logical name Editor: to whatever your editor is.
  67.         E.G.  Assign Editor: DH0:c/UEdit
  68.         This will issue the command 'DH0:c/UEdit <selected file>' whenever
  69.         you click on the program's EDIT gadget.  (Any editor can be used, 
  70.         even my worst enemy, AmigaDOS's 'ED'.)
  71.         
  72.     -   Tell the program where your soft fonts are.  This is not necessary
  73.         if you don't have any soft fonts. (obviously!)
  74.         First create a directory on your disk where you will have your soft
  75.         fonts stored.  Next create a subdirectory for each font set you want.
  76.         After that place the fonts into each subdirectory naming them with
  77.         just a number describing their font POINT.
  78.         
  79.         Your directory should look something like this:
  80.         
  81.         HP_Soft_Fonts (dir)
  82.             Helvetica (dir)
  83.                 8
  84.                 10
  85.                 12    (these are your soft fonts files.)
  86.                 24
  87.                 36
  88.             Times (dir)
  89.                 6
  90.                 10
  91.                 12
  92.             Tiny (dir)
  93.                 5
  94.             
  95.             etc . . . . 
  96.             
  97.         All the fonts are standard HP soft fonts files from the IBM PC world
  98.         with the .SFP or .SFL extension.
  99.             
  100.         After than you have to assign the name HPFonts: to where your soft
  101.         font directory is:
  102.             Assign HPFonts: DH0:HP_Soft_Fonts
  103.             
  104.     -   You MUST have ARP.LIBRARY version 1.1 or higher.  If you do not know
  105.         what this is, ask around in the AmigaTech forum or email me in
  106.         Compuserve on 75166,2531.
  107.         
  108.  
  109.  
  110.     Now that we have gotten through the tedious stuff, time for some fun!
  111.  
  112.  
  113. PROGRAM USE:
  114. ------------
  115.     
  116.     Run the program from either the CLI or Workbench.  You should get a big
  117. window with tons of gadgets.  Don't worry, most of these are very easy to
  118. understand.
  119.  
  120.     Notice that the cursor is on the 'File To Print:' gadget.  Press
  121. 'Return' and you will get a file requester for selecting which file to print.
  122. This is like any other requester you might have seen except for one thing: 
  123. If you click the RIGHT mouse button you will get a list off all the system
  124. Devices added to the list of files.
  125.  
  126.     After selecting the file you want the requester will disappear.  If your
  127. printer is connected to the parallel port, fine, otherwise click on the
  128. gadget saying 'Parallel' to change this into 'Serial'.  Next click on
  129. 'PRINT'.  And that's that!
  130.  
  131.  
  132.  
  133. DESCRIPTION OF GADGETS:
  134. -----------------------
  135.  
  136.     This is a description of all the program's gadgets, which is intended to 
  137. be a full description of the program's facilities:
  138.     
  139.     
  140.  1. Directory/File To Print:
  141.  
  142.     These two work together in order to select a file.  You can directly type
  143.     in the name of the file you want to print in either of them.  If the
  144.     program can't find it, it will pop up the file requester.  If you only
  145.     enter a directory name, then the file requester will come up with the
  146.     directory you selected as the current directory.
  147.     
  148.     
  149.  2. PRINT:
  150.  
  151.     Very easy.  Click on this after you have made all the settings you need
  152.     and the file will be printed.  The gadget text will be replaced with the
  153.     number of the page currently being printed.
  154.     
  155.  3. STOP:
  156.  
  157.     This will stop printing a file.  A requester will appear asking you
  158.     whether you really want to stop printing.  Clicking on 'PRINT' while it
  159.     displays the page number will achieve the same effect.
  160.     
  161.  4. EDIT:
  162.  
  163.     This will load your favourite editor and load the currently selected file
  164.     (from the Directory/File To Print requester) into the editor.
  165.     WARNING:  If you did not assign anything to Editor: or assigned something
  166.     other than an executable program, you might well meet the guru.
  167.     If you get a requester asking you to 'Please insert volume Editor in any
  168.     drive', do not CANCEL the requester, or the program will guru, instead,
  169.     open a CLI, and assign Editor: to C:ED for example, and click on Retry.
  170.     
  171.  5. Serial/Parallel:
  172.  
  173.     This is the port your printer is connected to.  It does not reflect the
  174.     printer currently selected from Preferences.
  175.     
  176.  6. Landscape/Portrait:
  177.  
  178.     This selects which orientation the text will be printed in.
  179.     
  180.  7. Wide Print/Double Print:
  181.  
  182.     Wide   Print:  Normal printing.
  183.     Double Print:  Prints two pages on one paper.  (Try it to see what I
  184.                    mean.)  This is best used with the Line Printer font, or a
  185.                    similar small sized fixed spacing font.
  186.  
  187.  8. Font Selector:
  188.  
  189.     This selects the font from a list of about 14 fonts.  The font will only
  190.     be selected if it exists in the printer's internal font list or in one of
  191.     the installed cartridges.  To select a font just keep clicking on the
  192.     gadget until you find the font you want.  If you select 'SOFT FONT'
  193.     another gadget will appear with the currently selected soft font.  To 
  194.     select any other font, click into the soft font gadget and press 'Return'.  
  195.     A file requester will come up with the names of font sets.  Select the 
  196.     font set you want and then the font size.  The soft font will be
  197.     automatically downloaded from the disk into the printer when you select 
  198.     the 'PRINT' gadget.
  199.     
  200.  9. Page Size:
  201.  
  202.     This will select one of four default paper sizes:  A4, Letter, Legal, and
  203.     Executive.  Or you can use 'Custom' for your own paper size.
  204.     
  205. 10. Length:
  206.  
  207.     This is the paper length in inches.
  208.     
  209. 11. Width
  210.  
  211.     This is the paper width in inches.
  212.     
  213. 12. Pitch:
  214.  
  215.     This is the font pitch.  This affects which font will be selected when
  216.     printing.  This also affects the number of characters per line.
  217.     
  218. 13. Point:
  219.  
  220.     This is the font point.  This also affects which font will be used. 
  221.     This also changes the Lines Per Inch and the number of lines per page.
  222.     
  223. 14. Lines Per Inch:
  224.  
  225.     This is the number of lines per inch.  Control ranges from 0 to 24 in
  226.     increments of .1, allowing very fine control of line spacing.  Use with
  227.     discretion!
  228.     
  229. 15. Margins:  Left, Right, Top & Bottom:
  230.  
  231.     These are fairly evident.  (You can use these to print on any size of
  232.     paper, including envelopes.)
  233.     
  234. 16. Tab:
  235.  
  236.     This selects the number of spaces that will be used instead of a tab. 
  237.     The default for this is 5.  A selection of 0 will turn off tab printing.
  238.     
  239. 17. Number of Copies:
  240.  
  241.     This selects the number of copies required of the printed file.  This
  242.     will currently only work with the LJ Series II printer as the older
  243.     printers do not have a 'number of copies' command.  Sorry!
  244.     
  245. 18. Characters Per Line:
  246.  
  247.     This number is calculated from the Paper Width and the Font Pitch.  You
  248.     can, however, enter a number directly in here to have the font pitch
  249.     recalculated to suit this number.  Use carefully.
  250.     
  251. 19. Lines Per Page:
  252.  
  253.     This is calculated from the Paper Length and the Lines Per Inch.  You
  254.     can, however, enter a number directly in here to have the Lines Per Inch
  255.     recalculated to suit this number.
  256.     
  257. 20. Bold:
  258.  
  259.     This will select whether a font is printed in Bold or not.
  260.     
  261. 21. Italic:
  262.  
  263.     This will select whether a font is printer in Italics or not.
  264.     
  265. 22. Font:  Fixed or Proportional:
  266.  
  267.     This currently does not work correctly.  It now only corrects tab
  268.     alignment when printing proportional fonts.  There will be more support
  269.     for proportional fonts in a future release.
  270.     
  271. 23. Numbering:
  272.  
  273.     This will print a line number in front of every line in the file being
  274.     printed.  It has the following options:
  275.     
  276.         OFF :   No line numbers printed.
  277.         PAGE:   The numbering is reset every page.
  278.         FILE:   The numbering is used for the whole file.
  279.         
  280. 24. Headers:
  281.  
  282.     This will print a line on top of each page with some info on the file
  283.     being printed:
  284.     
  285.         OFF :   No Header Printed.
  286.         PAGE:   Prints the current page number.
  287.         FILE:   Prints the file name.
  288.         ON  :   Prints both the page number and file name.
  289.         
  290. 25. Time/Date:
  291.  
  292.     This works in conjunction with the previous gadget and adds a time/date
  293.     stamp on each page's header.
  294.     
  295. 26. Vertical Line:
  296.  
  297.     This only works if 'Double Print' is selected.  If this gadget is on, a
  298.     vertical line separating the two logical pages will be printed across the
  299.     center of the paper.
  300.     
  301. 27. Preset Buttons:  1,2,3,4,5,6 & 7:
  302.  
  303.     These are storage places for all the gadget selections in front of you. 
  304.     They allow you to have different settings for different jobs.
  305.     
  306. 28. Load & Save:  L  &  S:
  307.  
  308.     The 'S' (Save) gadget saves all the programs, current presets into a
  309.     configuration file on the program's directory called 'LJP-Config'.
  310.     This file is automatically loaded when you start the program.
  311.     The 'L' (Load) gadget will load the last saved settings.
  312.     
  313. There are also some hidden gadgets:
  314.  
  315. 29. Presets/Locked:
  316.     
  317.     This is the 'Preset' next to the preset numbers.  If this is click upon,
  318.     the text will change to 'Locked' and you can change the preset number
  319.     without affecting the current settings.  This can be used to copy
  320.     settings from one preset to another.  E.G.  To copy Preset 1 to Preset 5,
  321.     select Preset 1, click on 'Preset', select Preset 5, and then click on
  322.     'Locked.'  Voila!
  323.     
  324. 30. File Name Lock:
  325.  
  326.     Click between the Directory and the File To Print gadgets.  An 'L' will
  327.     appear.  This will lock the file name so that you can change the Presets
  328.     without affecting the file name.
  329.     
  330. 31. Sleep:
  331.  
  332.     This is a hidden gadget in top left-hand corner of the program's window. 
  333.     If you click there, the program will go to sleep, and a tiny window will
  334.     appear instead of the program's window.  You can move this window out of
  335.     the way if you like.  Click into this window again to wake the program up.
  336.     The position of the sleep window is also saved as part of the program's
  337.     setting when you select the 'Save' gadget.
  338.     You can also have the program come up in the sleep mode if you use the
  339.     CLI.  Just issue the command:  LJP SLEEP.
  340.     
  341.     This will also free up about 20 kilobytes of the program's 55K of memory
  342.     usage while the program is sleeping in case you need some extra memory.
  343.     
  344.     
  345.  
  346. THE END:
  347. --------
  348.  
  349.     Well, Folks.  That's about it.  Sorry about the docs being so long, but I
  350. guess the program warrants such a detailed description,  even if only so that
  351. I don't forget how the program works! (grin)
  352.  
  353.     This program may be distributed through any means as long as this file,
  354. the program itself, and the .info file are kept together, and are not used
  355. as part of any commerical package.
  356.  
  357.       I do not wish to place the program in Public Domain right now since I
  358. have worked for more than three months on it, but still need to polish it
  359. some more.
  360.  
  361.     I have tested the program extensively for about one month before
  362. releasing it, but if you find any bugs, problems, or if you have any 
  363. complaints, suggestions, etc. about the program you can contact me in the
  364. AmigaTech Forum on Compuserve or via Email.
  365.  
  366.     Many thanks to all the people on the AmigaForum for all their support and
  367. insights on how to program this wild beast.
  368.  
  369.                                     Khalid Aldoseri,
  370.                                     75166,2531.
  371.